About the Component
===================

Thank you for buying our component. We hope youll find it useful.

The Flashtuning Scroll Bar component provides extended scrolling control over any content type within movie clip and adapts automatically for both static and dynamic types of content.

The Scroll Bar can be configured to work in either free or snapped to content modes. You can use it in either vertical or horizontal modes and you can configure two component instances to create a Scroll Pane.

This component is available for:
FLASH CS3 (ActionScript 3.0).


Features
========

- Scroll any movie clip and layout components (eg. Flashtuning Table Renderer, Adobe Flash Datagrid)

- Horizontal/Vertical orientation

- Switch scrolling targets during runtime

- Choice and adjustment of scroll easing types

- Choice of scrollbar layouts (buttons and slider, buttons only, slider only)

- Run-time resizible visible area

- Free/Snap to visible area modes

- Autohide/disable feature

- Mouse wheel support

- Customizable skins on per instance or global basis (per instance customization available in Advanced version)

- Skin elements color overlays (available in Advanced version)

- Scrollbar events to integrate various functionality extensions

- Dynamic control through Actionscript API

- Built in Help Book that can be accessed via the Flash Help Panel



Installation
============

Follow the steps below to setup your component.

(i) Flashtuning Flash Components are installed by using the Adobe Extension Manager. You need to have this software installed before continuing with the component setup.
    You can download the Extension Manager from http://www.adobe.com/exchange/em_download/

(1) Extract the contents of the .ZIP pack you received to a location on your hard drive.

(2) Start the Adobe Extension Manager using one of these methods:

    - Double-click the component (.MXP) file in Windows Explorer (Windows) or in the Finder (Macintosh).
    - In Flash, select (m) Help / Manage Extensions.
    - In Windows, select (m) Adobe / Adobe Extension Manager from the Start menu.
    - On the Macintosh, double-click the Extension Manager icon in the Applications/Adobe Extension Manager folder.

(3) From the Product pop-up menu in the Extension Manager toolbar, select Flash.

(4) Select (m) File / Install Extension in the Extension Manager.

(5) In the file-selection dialog box that appears, select the component (.MXP) file and click Install.

(6) Read the component license and select Accept to continue with the installation, or select Decline to cancel the installation.

(7) If you have a trial or previous version of the component already installed, youll be asked if you would like to replace one or more existing files, select Yes or Yes to All to accept the version or version included in the component file, or No to keep the existing version of the component.
    If you click Cancel, the installation will be cancelled and no files will be installed or replaced.



Getting started
===============

Your component should now be installed and ready to use in Flash. Outlined below is a simple, generic use scenario that you may wish to perform to get familiarized with the component.
The goal for the following example is to set up a simple scrolling movie clip with text inside. 


1 Start Adobe Flash, open a new document and set a 30 fps in the Document Properties Panel.

2 Open the Components Panel ( (m) Window/Components). You will find the component in the Flashtuning folder.

3 Drag the component (FtScrollBar) from the Components Panel to the stage. The component graphic symbol should now be displayed on the stage.

4 Create a new movie clip to be scrolled:
  - Create a text field on the scene and type in few lines of text.
  - Select the text fields and convert them  to a movie clip symbol ( (m) Modify/Convert to Symbol) having the registration point top left. 
  - Give the new movie clip an unique instance name (in the Properties panel). 
      

5 Select the component on the stage and configure its parameters in the Parameters Panel or in the Component Inspector Panel ( (m) Window/Component Inspector):
  - Instruct the component to scroll the newly created movie clip as the target movie clip ( (I) targetMovieClip).
  - Set the (I) viewAreaHeight and (I) viewAreaWidth.
  - Set the snapMode to snapToView value.  
  - Leave the rest of the parameters unchanged unless you want to adjust some values, as they are already populated with default settings.

6 Test the scene (Control/Test Movie). 

(i) Please refer to the Flashtuning Scroll Bar component Flash Help Book for more information and options included with the Scroll Bar.



FAQ
===


How can I access the component's Flash Help Book ?

The component comes with a built in Help Book with all the supported methods/properties and events explained and you can access the files via the Flash Help Panel. You will find the book under the name Flashtuning Scroll Bar or you can perform a search under the flashtuning or adjacent keyword and the documentation files will be automatically displayed. 



How can I change the skin elements? Where can I find them?

The skin elements can be found in the trial package / assets folder. You will find how you can change the skin elements in the Help Book / Customizing the FlashtuningScrollBar section. 



What does dynamic/run-time customization mean ?

The customization of the component is either skin or color based and you can dynamically alter the look of the components at runtime using these properties to get one or more component instances having a different look.
If you are using the skin properties you need to have the scroller assets symbols in the library exported for Actionscript. You can find what skin and color properties are supported in the Help Book / Customizing the FlashtuningScrollBar component section.



How can I set the scroll amount using ActionScript ?

You can set the scroll amount using the scrollPercentage property.
Example: myScrollBar.scrollPercentage = 40;



What is the sliderOffset property ?

The sliderOffset property is a numeric value representing the distance between the Scroll Bar slider and the top/bottom ends of the Scroll Bar track. It works only when the component is used in Scroll Bar mode. The default value for this property is 4px.




Further Reference
=================

This Guide offers limited information. To learn more about the component, for the complete list of features, capabilities and more detailed guides, please consult the full documentation.
For further reference you can check the built in documentation files that are automatically installed with the product. You can access the embeded component's help files directly in Flash via the Flash Help Panel/Flashtuning Scroll Bar Scene folder.
